package com.youlai.boot.modules.game.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.youlai.boot.modules.game.model.entity.GameInfo;
import com.youlai.boot.modules.game.model.form.GameInfoForm;
import com.youlai.boot.modules.game.model.query.GameInfoQuery;
import com.youlai.boot.modules.game.model.vo.GameInfoVO;

import java.util.List;

/**
 * 游戏信息服务接口
 *
 * @author 有来技术团队
 */
public interface GameInfoService extends IService<GameInfo> {

    /**
     * 分页获取游戏列表
     *
     * @param queryParams 查询参数
     * @return 分页结果
     */
    Page<GameInfoVO> getGamePage(GameInfoQuery queryParams);

    /**
     * 获取游戏详情
     *
     * @param id 游戏ID
     * @return 游戏详情
     */
    GameInfoVO getGameDetail(Long id);

    /**
     * 新增游戏
     *
     * @param formData 表单数据
     * @return 游戏ID
     */
    Long addGame(GameInfoForm formData);

    /**
     * 修改游戏
     *
     * @param id 游戏ID
     * @param formData 表单数据
     * @return 是否成功
     */
    boolean updateGame(Long id, GameInfoForm formData);

    /**
     * 删除游戏
     *
     * @param ids 游戏ID列表
     * @return 是否成功
     */
    boolean deleteGames(List<Long> ids);

    /**
     * 获取推荐游戏列表
     *
     * @param limit 限制数量
     * @return 推荐游戏列表
     */
    List<GameInfoVO> getFeaturedGames(Integer limit);

    /**
     * 获取热门游戏列表
     *
     * @param limit 限制数量
     * @return 热门游戏列表
     */
    List<GameInfoVO> getHotGames(Integer limit);

    /**
     * 获取新品游戏列表
     *
     * @param limit 限制数量
     * @return 新品游戏列表
     */
    List<GameInfoVO> getNewGames(Integer limit);

    /**
     * 根据分类获取游戏列表
     *
     * @param categoryId 分类ID
     * @param limit 限制数量
     * @return 游戏列表
     */
    List<GameInfoVO> getGamesByCategory(Long categoryId, Integer limit);

    /**
     * 增加游戏下载次数
     *
     * @param id 游戏ID
     * @return 是否成功
     */
    boolean incrementDownloadCount(Long id);

    /**
     * 更新游戏评分
     *
     * @param id 游戏ID
     * @param rating 评分
     * @return 是否成功
     */
    boolean updateRating(Long id, Double rating);
} 